package com.waikuai.shop.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.waikuai.shop.entity.ProductCategory;
import com.waikuai.shop.vo.CategoryTreeVO;

import java.util.List;

/**
 * 商品分类服务接口
 * @author waikuai
 */
public interface ProductCategoryService extends IService<ProductCategory> {

    /**
     * 获取分类树结构
     * @return 分类树列表
     */
    List<CategoryTreeVO> getCategoryTree();

    /**
     * 获取顶级分类列表
     * @return 顶级分类列表
     */
    List<ProductCategory> getTopLevelCategories();

    /**
     * 根据父分类ID获取子分类列表
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<ProductCategory> getCategoriesByParentId(Long parentId);

    /**
     * 获取启用的分类列表
     * @return 启用的分类列表
     */
    List<ProductCategory> getEnabledCategories();

    /**
     * 创建商品分类
     * @param category 分类信息
     * @return 创建结果
     */
    boolean createCategory(ProductCategory category);

    /**
     * 更新商品分类
     * @param category 分类信息
     * @return 更新结果
     */
    boolean updateCategory(ProductCategory category);

    /**
     * 删除商品分类
     * @param categoryId 分类ID
     * @return 删除结果
     */
    boolean deleteCategory(Long categoryId);

    /**
     * 检查分类名称是否存在
     * @param categoryName 分类名称
     * @param excludeId 排除的分类ID
     * @return 是否存在
     */
    boolean checkCategoryNameExists(String categoryName, Long excludeId);

    /**
     * 统计分类下的商品数量
     * @param categoryId 分类ID
     * @return 商品数量
     */
    Integer countProductsByCategoryId(Long categoryId);

    /**
     * 构建分类树结构
     * @param categories 分类列表
     * @return 分类树
     */
    List<CategoryTreeVO> buildCategoryTree(List<ProductCategory> categories);
}